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(Mira) Hello. Tin trying to collect a list of all the jcurrent_issues 
making tct a bad language choice. I'd like concrete examples, and 
not just vague assertions that . . . 

MAC-address 

(Jannsen) High, is there a way to get the MAC- addresses and other 
properties of network cards with python? Ihanx. Holger . . . 

Asserting object class 

(Adi) In a method, I'd like to asset that a parameter is an object 
which is of a specific class or has this class as it's base class. I can 
test on the _class_ and its . . . 

KBHLT in a Windows Environment 

(Zimmerle) I amusing Python 1,52 in a Windows 98 environment 
I recently tried using the kbhit() function in the msvert module. It 
appears to work fine in the Python . . . 

Pythonwm - advise sought 

(Williams) I am looking at Python win as an alternative to Tk and 
would appreciate advice on the following three questions. The 
Pythonwin documentation points to MFC ... 

force sequenz with only one item? 

(Jannsen) High, I thin it's easy to solve, but I couldn't get it right 
now. Take a look at the command-line source below: »> A = 0 
>» B = 1 >» seq=raw_input("7") ?A3>» ■ • • 

Date formats 

(Milliger) I read the documentation in the Python Reference 
Library (6.3) on time access and conversions and chapter 8 in 
programming python, yet I can't figure out if . . . 

Advice on an how to ha ndle errors in extension module. 

(Oliphant) I'm writing some Python-C interfaces to some 
mathematical libraries in FORTRAN. In particular, I'm working 
on interfacing QUADPACK with Python, The code is . . . 
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1 73 . k mcdermott(@mv-deia.com 06/1 1 /99 02:37 

Hi. I am trying to send a plain text file, as an attachment through e- 
maii. This is a hacked version of my test code below, basically fee 
program interprets a dump from a diary * . . 

1 84. M.-A. Lembuig 06/1 1/99 06:07 

Reading the source in MimeWrite.py Fd suggest moving these *r 
lines up just behind the subwrite = . line. The startbodyO call 
flushes the headers for you . . . 



-302 



221. Victor Kolosov 06/11/99 07:06 ^-—302 

Here is the right sequence (first write header then body), subwriter 
=- w.nextpartO subwriter.addheader("Content-Transfer-Encoding M , 
"base04")... 



200. k mcdermott^g>mv-deia.com 06/1 1/99 08:02 

^-302 



Thanks Marc-Andre. It works great (good guess). Guidohad>r 
posted a message almost a year ago (which the code 1 wrote is a 
modification of) but I couldn't quite . . . 
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[Schulenburg: I have been using a freeware product called 
Autoduck to document my Python source code] 



Cool! I use AutoDuck to document all my Python extension C++ code. All the 
belpfiles in the Win32 extensions are generated using autodock. 

Sony in advance for the length of this, but I am in exactly the same 
predicament as you, and have been thinking for a number of years how to resolve 
this. I'm really pleased to finally find someone else with this problem, and really 
hope we can solve it in a reasonable way — 

However, depending on how far you have gone with AutoDuck, pythondoc/gendoc 
isn't solving the exact same problem. 

IMO, AutoDuck generates tar superior reference documentation. 

A new release of pythondoc uses XML I believe, so PythonDuck could be a 
tool that can enhance the documentation generated by pythondoc. 

But in summary, Pythondoc exists and is very cool, but doesn't quite cover 
what AutoDuck can do (and vise-versa, but that isn't the point now). I believe a real 
need exists for the functionality AutoDuck provides, and further I need it personally! 
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[Schulenburg: I have been using a freeware product called 
Autoduck to document my Python source code.] 



Cool! I use AutoDuck to document all my Python extension C++ code. All the 
helpfiies in the Win32 extensions are generated using autoduck. 

As another poster pointed out, you should look at pythondoc/gendoc. Sorry in 
advance for the length of this, but I am in exactly the same predicament as you, and 
have been thinking for a number of years how to resolve this. I'm really pleased to 
finally find someone else with this problem, and really hope we can solve it in a 
reasonable way. 

However, depending on how far you have gone with AutoDuck, pythondoc/gendoc 
isn't solving the exact same problem. Well, they all attempt to solve the same 
problem, but have different strengths. 

IMO, AutoDuck generates far superior reference documentation. Pythondoc 's big 
strength is the integration with Python. 

AutoDuck as 3 strengths over pyfhondoc that I am having trouble reconciling: 
pythondoc really doesn't support natural links to objects. Autoduck can say "see 
method*' or "@xref objectmethod" to generate inline links or a cross-references 
section. Has been some discussion how to expand Pythondoc to support this, but a) it 
hasn't been done and b) it still is not as natural as autoduck. 

I have come to the conclusion that we need a _new_tool - PythonDuck. It should 
work with Pythondoc, and be capable of enhancing its output. A new release of 
pythondoc uses XMI. 1 believe, so PythonDuck could be a tool that can enhance the 
documentation generated by pythondoc. Alternatively we just graft it in, and beat up 
Daniel until he agrees :-) 

This tool could possibly still work from comments, or maybe from the tad-end of the 
docstrings (thereby stripped from the documentation, and not messing the raw 
docstring too much). #@ comments could be considered "directives' 1 for the 
generated output Eg. * 4 #@ xref SomeOtherFunction" will create a cross-references 
section. A comment such as #@ paramtype param name" would direct that the 
param called "paranwiame" should be documented as being of type ^SomeType" 
and a cross-reference to the SomeType definition be added. The tool should resolve 
all links at the end, and report bad links. 

1 know I am not making my point that well, and unfortunately don't have time to fix 
this. But in summary, Pythondoc exists and is very cool, but doesn't quite cover 
what AutoDuck can do (and vise-versa, but that isn't the point now). I believe a real 
need exists for the functionality AutoDuck provides, and further I need it personally! 
So wc should try and make this happen. 



Mark. 
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